home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 6 / QRZ Ham Radio Callsign Database - Volume 6.iso / mac / files / amiga / amiganos.lha / AmigaNOS-Utilities.PRT < prev    next >
Text File  |  1993-12-05  |  11KB  |  292 lines
  1. #1zz
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           AmigaNOS Utilities                               December 5, 1993
  8.  
  9.  
  10.           Legal Mumbo Jumbo:
  11.  
  12.           These AREXX  programs and  documentation are  Copyright   1993 by
  13.           Dan Roman.  Permission is  granted  to  redistribute  and  use or
  14.           modify the same as FREEWARE.  Please credit me if you use my work
  15.           and  I'd  like  to  see  the  results  of   any  improvements  or
  16.           modifications you make.
  17.  
  18.           The only warranty is "It works for me."
  19.  
  20.  
  21.           How to contact the author:
  22.  
  23.           My  amateur  call  sign  is  N2MFC  and  I  can be reached at the
  24.           following addresses (in order of preference):
  25.  
  26.           1) Internet as roman@tix.timeplex.com
  27.           2) or D.ROMAN1@genie.geis.com
  28.           3) GEnie as D.ROMAN1
  29.           4) Amateur radio TCP/IP as n2mfc%n2mfc@w2nv.ampr.org
  30.           5) Amateur radio AX.25 BBS as n2mfc@n2imc.#nnj.nj.usa.na
  31.  
  32.  
  33.           What's in here and what does it do?
  34.  
  35.           Contained in the archive with this documentation you  should find
  36.           the following  files which  pertain to using AmigaNOS for amateur
  37.           radio TCP/IP:
  38.  
  39.           AmigaNOS-Utilities.doc   What you are reading now.
  40.           SendMail.rx              AREXX program to allow  various versions
  41.                                    of ELM to work with AmigaNOS.
  42.           Announcer.rx             A little  gizmo which  allows you to let
  43.                                    people page you or run programs  on your
  44.                                    Amiga by sending mail to your Amiga.
  45.  
  46.           Why did  I choose to use AREXX over C?  First, not everyone has a
  47.           C compiler and AREXX comes standard with the AmigaDOS.   There is
  48.           a  lot  of  room  for  variation from system to system especially
  49.           among amateurs using AmigaNOS, AREXX allows the user to customize
  50.           these routines  for use  with his  specific needs.  Second, AREXX
  51.           allows for very quick development of routines like  these.  Speed
  52.           is not critical and AREXX handles the job quite nicely.  This was
  53.           a nice little job that did not justify  C and  if C  was the only
  54.           way to  do it  I probably  would not have invested the time to do
  55.           it!
  56.  
  57.  
  58.  
  59.  
  60.                                           1 z
  61.  
  62.  
  63.  
  64.  
  65.           AmigaNOS Utilities                               December 5, 1993
  66.  
  67.  
  68.           Setting up SendMail:
  69.  
  70.           The instructions below assume you are using AmigaELM version 1.17
  71.           by      Andreas      M.      Kirchwitz      (Internet     address
  72.           amk@zikzak.in-berlin.de).    There  are  other  version   of  ELM
  73.           available  and  although  none  are  tailored  to  amateur  radio
  74.           specifically and therefore have  many  drawbacks,  this  one does
  75.           work fairly well.
  76.  
  77.           1)   You need  to make the following two aliases which your shell
  78.                running ELM can use:
  79.  
  80.                     alias sendmail rx SendMail.rx
  81.                     alias rmail rx SendMail.rx
  82.  
  83.                AmigaELM  calls  either  sendmail  or  rmail  (depending  on
  84.                whether or  not it  is doing a reply) and feeds it the email
  85.                message from stdin.   Aliasing  the  AREXX  execution allows
  86.                sendmail.rx to take stdin and process it.
  87.  
  88.           2)   You must  have the  assignment for ELM's uumail: pointing to
  89.                your AmigaNOS Spool/Mail directory.
  90.  
  91.           3)   The following  ELM  parameters  should  be  set  in  the ELM
  92.                uulib:Config file.   I  use my  call, N2MFC in all examples.
  93.                ELM parameters which I  have not  listed are  unimportant to
  94.                SendMail.
  95.  
  96.                     NodeName n2mfc
  97.                     UserName n2mfc.txt
  98.                     RealName Dan Roman
  99.                     DomainName  .ampr.org
  100.                     DefaultNode n2mfc
  101.  
  102.           4)   The  following  ELM  parameters  should  be  set  in the ELM
  103.                uulib:.elm/elmrc file.   ELM  parameters  which  I  have not
  104.                listed are unimportant to SendMail.
  105.  
  106.                     SendmailVersion      Feulner
  107.  
  108.           5)   You must  edit two  lines in the beginning of SendMail.rx to
  109.                assign  the  variables  mailhost   and  stationcall.     See
  110.                SendMail.rx for more information.
  111.  
  112.           NOTE:  SendMail uses the T: directory for temporary files.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                           2 z
  119.  
  120.  
  121.  
  122.  
  123.           AmigaNOS Utilities                               December 5, 1993
  124.  
  125.  
  126.           Using SendMail:
  127.  
  128.           When you send or reply to a mail message using ELM, ELM will call
  129.           the SendMail.rx AREXX program.   You  must  however  be  aware of
  130.           several things  in the  use of ELM which affect SendMail.  ELM is
  131.           not 100% clean in these respects.
  132.  
  133.           1)   The To:  line  should  contain  only  one  address, multiple
  134.                addressees  are  not  supported.   SendMail simply passes on
  135.                addressing to AmigaNOS for the  smtp  command  to  use.   It
  136.                creates  files  in  the  AmigaNOS Spool/MQueue directory and
  137.                updates the file sequence.seq as necessary.
  138.  
  139.           2)   Provisions are made within  SendMail to  allow up  to 10 cc:
  140.                address to be placed on one line and 10 bcc: addresses to be
  141.                placed on one line.  Place  these lines  after the  To: line
  142.                and before the Subject: line.  For example:
  143.  
  144.                     To: ron
  145.                     Cc: bill steve ka9q@ucsd.edu
  146.                     bcc: joe john g1yyh@g1yyh.ampr.org
  147.                     Subject: Test of sendmail.
  148.  
  149.                SendMail  creates  individual  files  for  AmigaNOS  smtp to
  150.                process for each recipient.
  151.  
  152.           3)   This has nothing to do with SendMail really but is important
  153.                for using  ELM.   You must leave a blank line in between the
  154.                header information (usually the Subject: line)  and the body
  155.                of the text.  Otherwise, ELM on receiving mail will consider
  156.                part of the body of text  header information  (until a blank
  157.                line is  reached).  This method of implementing ELM for this
  158.                version allows headers to  be  added  easily  and simplified
  159.                coding by  leaving it  up to  the user to design and compose
  160.                the header properly but it  is  not  consistent  with recent
  161.                revisions of ELM (ie 3.4) on Unix workstations.
  162.  
  163.           NOTE:   SendMail does  some processing of header information that
  164.           ELM passes on and adds the date to the header.  SendMail attempts
  165.           to  read   the  TZ  environment  variable  to  get  the  timezone
  166.           information (defaults to GMT).  See SendMail.rx for more details.
  167.  
  168.  
  169.           Setting up Announcer:
  170.  
  171.           1)   Edit  the   variables   mailfile,   modemport,  modemstring,
  172.                modemringdelay, beeperstring,  and beeperdelay  as needed in
  173.                the top of Announcer.rx,  see Announcer.rx  for details.   I
  174.                chose the  user "robot"  for Announcer  to use on my system.
  175.  
  176.                                           3 z
  177.  
  178.  
  179.  
  180.  
  181.           AmigaNOS Utilities                               December 5, 1993
  182.  
  183.  
  184.                Announcer deletes the mail  file after  processing it  so be
  185.                sure you don't use YOUR mailbox!
  186.  
  187.           2)   Edit the file Announcer.commands in your TCPIP: directory to
  188.                include the programs you want Announcer to be able to run.
  189.  
  190.           3)   You must have the SPEAK: device mounted in order to have the
  191.                PAGE and PAGEMESSAGE functions work.
  192.  
  193.           4)   You must  have either  AmigaNOS or  a cron  type program run
  194.                Announcer periodically.  I suppose  you  could  have  it run
  195.                continuously and  putting a  wait delay in the AREXX program
  196.                but I chose not do do  it on  my system.   To  have AmigaNOS
  197.                execute Announcer  once every five minutes you would put the
  198.                following two lines in your nos-startup:
  199.  
  200.                     amiga interval 300
  201.                     amiga command rx TCPIP:Announcer.rx
  202.  
  203.           Using Announcer:
  204.  
  205.           1)   Announcer commands are placed on the  subject line  and sent
  206.                to  the   user  configured   in  the  mailfile  variable  in
  207.                Announcer.rx, it currently supports the following commands:
  208.  
  209.                PAGE {message}
  210.  
  211.                Uses the Amiga's narrator device (via  SPEAK:) to  "say" the
  212.                text on  the subject  line.   If the optional message is not
  213.                provided, the PAGE command  will use  the from  line to make
  214.                the announcement.
  215.  
  216.                PAGEMESSAGE
  217.  
  218.                Like PAGE  but uses  the body  of the  message to figure out
  219.                what to "say".  The text to be  spoken should  follow a line
  220.                which contains  only [START].   The  text will  be spoken up
  221.                until a line which contains only [END].
  222.  
  223.                PHONEHOME
  224.  
  225.                Uses the information in the configuration variables and your
  226.                modem  to  dial  a  phone  number  and  then hang up after a
  227.                variable amount of time.
  228.  
  229.                BEEPER
  230.  
  231.                Like PHONE  HOME except  it dials  the number  of a personal
  232.                pager or beeper and sends a message to display.
  233.  
  234.                                           4 z
  235.  
  236.  
  237.  
  238.  
  239.           AmigaNOS Utilities                               December 5, 1993
  240.  
  241.  
  242.  
  243.                RUN program
  244.  
  245.                Checks Announcer.commands to see of "program" is in the list
  246.                of programs Announcer is permitted to run and  then executes
  247.                the  program.    Announcer  then  waits  for that program to
  248.                return control.
  249.  
  250.           2)   After processing successfully the commands in the mail file,
  251.                Announcer deletes  the file so that the commands will not be
  252.                run again.
  253.  
  254.           3)   Announcer keeps a  log  of  the  commands  it  processes and
  255.                reports  any   errors.     This  information  is  stored  in
  256.                TCPIP:Announcer.log and is created if it  does not  exist or
  257.                appended to if it does.
  258.  
  259.           The  possibilities  are  endless  for  a  program like Announcer,
  260.           hopefully these commands are a good start for ideas of  your own.
  261.           Got something  cool you  did with  it?   Let me know, I'd like to
  262.           hear from you.
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.                                           5 c